This document describes the steps that are necessary to install an AYS service into a new or existing stack. For a more detailed description of the events involved please refer to the user manual.
The first task is to identify the stack into which you wish to install the AYS service. You may use either a new or an existing stack. The stack that you choose should be capable of being set to scripting level 4 (authoring). This level of operation is only necessary for the last step of this exercise, which creates a set of card buttons. After the last step has been completed (or if the buttons are not required) the stack may be set to any level of operation. The chosen stack will henceforth be referred to as the target stack.
Now launch the AYS installer stack. After dispensing with the registration dialog box, the front card will contain a scrolling field of available sample services. Select whichever service you wish to install into the target stack by clicking on its name in the list; the stack will go to the card that describes that service. If you wish to satisfy yourself that the service works and is the one that you wish to install, you may firstly test it by selecting 'Test Service' from the 'Function' menu.
Should none of the sample services appeal, you may create your own service. To do this firstly select 'New Card' from the 'Edit' menu. This will create a new service card preset with defined, default values. Modify whichever fields are necessary including the service name and the name and configuration of the Connection and Terminal Emulation tools to be used. If the service requires a login and/or logout script then create the HyperTalk scripts necessary by clicking the 'Service Scripts' button. Once you have fully defined your new service you may test it by selecting 'Test Service' from the 'Function' menu.
Once satisfied with the service to be installed you must then define the stack into which it is to be installed. Select 'Define Target' from the 'Function' menu. The installer will firstly inform you of the current target stack and allow you to redefine it. Click the 'Reselect' button. Select the the name of the target stack from the resulting scrolling list of files. The installer will then ask you whether the service to be installed is to be installed as either a Macintosh resource or as HyperCard card. Selecting the latter will result in a new card being inserted into the target stack whilst selecting the former will result in the service being installed as an 'invisible' resource. Select whichever is appropriate.
You can now install the service by selecting 'Install into Target' from the 'Function' menu. If you had selected 'Cards' in the previous step, then the installer will inform you that the target stack does not contain an appropriate AYS template card. It asks if one should be inserted, click the 'Yes' button.
The installer will then inform you that the target stack does not contain the resources and HyperTalk scripts necessary to support the service just installed. It asks whether these items should be copied to the target stack. Click the 'Yes' button, the resulting action will take a few moments.
The AYS service has now been installed.
Activate the target stack and select a card that does not contain any card buttons. Type AYS into the message box to activate a script that generates a card button for each service installed plus a 'Text Edit' button. Clicking the buttons will result in the launching of the named service or of a text edit window. The card buttons may be cut and pasted anywhere within the target stack.
WARNING: if the service was installed as a resource then the target stack SHOULD NOT CONTAIN ANY CARD SCRIPTS. The reason for this, is that if the 'resource' service has any scripts associated with it (login, logout etc.) then these are firstly copied to the card script area of the current card before being executed. This results in the overwriting of any scripts that were originally in the card script area.
